6.3 `--allowedTools` - 允许的工具列表

--allowedTools 标志允许您指定应允许的工具列表，无需提示用户获得权限。这可以简化工作流程，减少权限提示的频率。

标志语法#

bash
复制
claude --allowedTools <tool1> <tool2> ... [其他选项]

功能描述#

--allowedTools 标志会：

1. 指定允许的工具列表
2. 这些工具在使用时不会提示用户获得权限
3. 其他工具仍会按正常权限流程处理

使用示例#

基本用法#

bash
复制

claude --allowedTools "Bash(git log:*)" "Bash(git diff:*)" "Read"

允许特定的 Bash 命令和 Read 工具。

允许读取工具#

bash
复制

claude --allowedTools "Read" "Grep" "Glob"

允许文件读取和搜索工具。

允许特定命令#

bash
复制

claude --allowedTools "Bash(npm test:*)" "Bash(npm run build:*)"

允许特定的 npm 命令。

结合其他标志#

bash
复制

claude --allowedTools "Read" "Edit" --add-dir ./src

允许读取和编辑工具，并添加工作目录。

工具格式#

工具的格式为：工具名称(模式)

• 工具名称：如 Bash、Read、Edit 等
• 模式：可选，指定工具的使用模式或参数

常用工具#

使用场景#

1. 只读操作#

bash
复制

claude --allowedTools "Read" "Grep" "Glob"

只允许读取操作，避免意外修改。

2. 安全命令#

bash
复制

claude --allowedTools "Bash(git log:*)" "Bash(git diff:*)"

只允许安全的 git 只读命令。

3. 测试命令#

bash
复制

claude --allowedTools "Bash(npm test:*)" "Bash(python -m pytest:*)"

只允许测试相关命令。

4. 构建命令#

bash
复制

claude --allowedTools "Bash(npm run build:*)" "Bash(cmake --build:*)"

只允许构建相关命令。

注意事项#

1. 权限覆盖：--allowedTools 会覆盖 settings.json 中的设置
2. 工具存在：指定的工具必须存在且可用
3. 模式匹配：工具模式应该准确，避免过于宽泛
4. 安全考虑：只允许真正需要的工具，避免安全风险
5. 权限提示：未在列表中的工具仍会提示用户获得权限

最佳实践#

1. 最小权限：只允许真正需要的工具，遵循最小权限原则
2. 明确模式：使用明确的工具模式，避免过于宽泛的匹配
3. 定期审查：定期审查允许的工具列表，移除不需要的
4. 文档记录：记录允许的工具及其原因
5. 测试验证：测试允许的工具是否按预期工作

与 --disallowedTools 的对比#

常见问题#

Q: 可以同时使用 --allowedTools 和 --disallowedTools 吗？#

A: 可以，--allowedTools 优先级更高，会覆盖 --disallowedTools。

Q: 工具模式支持通配符吗？#

A: 是的，支持 * 通配符进行模式匹配。

Q: 如何知道可用的工具列表？#

A: 可以使用 /tool list 命令查看所有可用工具。

Q: 允许的工具会持久化吗？#

A: 不会，--allowedTools 只对当前会话有效。要持久化，请在 settings.json 中设置。

相关标志#

• --disallowedTools：禁止的工具列表
• --dangerously-skip-permissions：跳过所有权限提示
• --permission-mode：指定权限模式

实际应用示例#

CI/CD 环境#

bash
复制

#!/bin/bash
# 在 CI/CD 中只允许安全操作
claude \
  --allowedTools \
    "Bash(git log:*)" \
    "Bash(git diff:*)" \
    "Read" \
    "Grep" \
  "审查代码变更"

只读分析#

bash
复制

#!/bin/bash
# 只读分析，避免意外修改
claude \
  --allowedTools "Read" "Grep" "Glob" \
  "分析这个项目的结构"